\chapter{Convenciones}
En esta secci'on mencionaremos algunas conveniciones que tendremos en cuenta
para la creaci'on del proyecto y poder llevarlo adelante de la mejor manera
posible; tratando de respetar est'andares y estilos de programaci'on. Con lo
cual el c'odigo ser'a lo m'as legible posible haciendo que los integrantes del
proyecto se entiendan estando a distancia y sin m'as que la simple explicaci'on
de las cosas por el c'odigo mismo.

\begin{description}
    \item [estilo] seguiremos en todo lo posible lo que dice el art'iculo
\footnote{http://python.net/~goodger/projects/pycon/2007/idiomatic/handout.html}
de {\em David Goodger}. Tambi'en para el estilo de programaci'on seguiremos la
PEP 8 (Python Enhancement Proposals) \footnote{Ingl'es:
http://www.python.org/dev/peps/pep-0008/
Castellano: http://mundogeek.net/traducciones/guia-estilo-python.htm} De esta
gu'ia dejamos en claro lo que quiz'as m'as se presta a confuci'on.

    \begin{enumerate}
        \item Una l'inea en blanco entre definici'on de funciones.
        \item Dos l'ineas en blanco entre las definiciones de clases.
        \item Para la inserci'on de {\em Docstrings} utilizamos las tripes
comillas dobles, dejando una l'inea en blanco antes de la primer palabra
y despu'es de la 'ultima.
        \item Los nombres de las funciones, variables, clases y dem'as estar'an
en ingl'es, para una mejor comprensi'on en el resto de las personas debido al
alcance que tiene el mismo.
        \item En cada archivo {\em .py} en la primera l'inea se le colocar'a la
referecia {\em \#!/usr/bin/env python} para poder hacer de este ejecutable, y
en la segunda l'inea {\em \# -*- coding: utf-8 -*-} que indica cu'al es la
codificaci'on que vamos a utilizar en el archivo.
    \end{enumerate}

    \item [parametros TurboGears] para todas las funciones hechas en TurboGears
en las cuales estas reciban par'ametros los mismos ser'an pasados de la forma
''bonita'' respetando lo que dice la documentaci'on oficial
\footnote{http://docs.turbogears.org/1.0/GettingStarted/Arguments}. De esta
manera si queremos pasar dos argumentos a la funci'on {\em index}, por ejemplo,
lo hacemos de la siguiente manera:

\begin{verbatim}
http://localhost:8080/index/Manuel/Kaufmann
\end{verbatim}

    Por lo que la funci'on {\em index} est'a recibiendo en el primer argumento
    la cadena {\em Manuel} y en el segundo {\em Kaufmann}.

    \item [filesystem] la estructura en el sistema de ficheros que utilizaremos
para guardar las fotos y su posterior lectura de forma correcta ser'a de este
modo:

\begin{verbatim}
/<proyecto>
    /images
        /<disco>
            /2007-08-03
                /thumbails
            /2007-08-04
                /thumbails
            [...]
            /<ano>-<mes>-<dia>
\end{verbatim}

    \item [hojas de estilo] los archivos de hojas de estilo con extenci'on {\em
css} se guardar'an en el directorio {\em ./static/css/}

\end{description}